home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 Christmas / macformat-045.iso / Shareware Central / QPict 2.1.1 / Documentation < prev    next >
Encoding:
Text File  |  1996-07-06  |  14.3 KB  |  288 lines  |  [TEXT/ttxt]

  1. last updated 960706 - for lastest info check out: http://www.glunet.se/qpict 
  2.  
  3. Introduction
  4. QPict is a graphics browser/viewer. It helps you organize and find graphics on your harddisk, CD-rom etc. The viewer part can currently display PICT, JPEG, GIF and Startupscreen file formats. All other filetypes are supported by using helper applications. You use QPict to organize your graphics the same way you organize files in the Finder by using drag and drop.
  5.  
  6. Features
  7. •    Extensive drag and drop support, including drop on application in Finder.
  8. •    Fast caching
  9. •    Fast screen redraw
  10. •    Multiple documents
  11. •    Slide show
  12. •    Displays PICT, GIF, JPEG and Startupscreen.
  13. •    Supports all other filetypes by calling helper applications
  14. •    Scans disks and folders that are dropped on QPict for graphic files
  15. •    Slide Show
  16. •    Robust preview creation for PICT, JPEG and Startupscreen files
  17. •    Many user selectable settings
  18. •    Supports self contained index files, a must for browsing CD:s
  19. •    Extensive keyboard navigation
  20. •    Simple interface
  21. •    Runs native on both 68K and PowerPC
  22. •    Mimics the Finder behaviour as much as possible
  23. •    Completion sound for time consuming operations
  24. •    User selectable textures/patterns
  25. •    Supports InternetConfig for easy access to QPict home page.
  26. •    Can change/restore resolution* and depth on startup/exit
  27. •    Reveal file location lets you quickly find the original file in Finder
  28. •    Basic scriptability
  29. •    Online shortcuts help
  30. •    Balloon help for menus
  31. •    Uses the latest technologies like the new translucent drag manager in System 7.5.3
  32.  
  33. and more...
  34.  
  35. * Not tested much, might cause problems on some machines/configurations (PCI Macs).
  36.  
  37. Shareware notice
  38. This program is distributed as shareware. See the "How to register" document for more information.
  39.  
  40. Minimum requirements
  41. Color QuickDraw capable Macintosh
  42. 4MB of free memory (depends on index size, System version and computer model)
  43. System 7.1 or later
  44. QuickTime 2.0 or later
  45.  
  46. Recommended
  47. 040 Mac or better
  48. 8 MB memory  or more(depends on index size, System version and computer model)
  49. System 7.5.1 or later
  50. DisplayManager 2.0 or later (required for resolution change)
  51. Support for 16 or 24 bit video
  52. QuickTime 2.1 or later
  53. DragManager (included in System 7.5 and later)
  54.  
  55. Usage examples
  56. The following examples will give you some ideas of what QPict can be used for.
  57.  
  58. Situation 
  59. You have several CD-Roms with graphics (pictures movies etc.). You want to have instant access to them without having mount them one by one. 
  60.  
  61. Solution
  62. To solve the problem, create index files for all items of you CD. Organize the way that suits you, eg. as graphic categories or by folder structure on the CD:s.
  63.  
  64. Situation
  65. You frequently receive a lots of pictures that you want to sort and trash unwanted ones.
  66.  
  67. Solution
  68. Drag and drop all the pictures (or the enclosing folder) on the QPict icon in the Finder. Press enter/space or return to view the first picture. If you want to delete the picture press backspace, otherwise press the right arrow to display next picture. When finished with all pictures, create preview for them. Open up a folder in Finder where you have your folder structure for your different picture categories. Align the window in a way that it's visible from within QPict. Drag and drop pictures from the index to the folders in Finder. Press and hold command-key during the drag to have the item in the index removed (that way you know which items are left to be sorted).
  69.  
  70. Situation
  71. You are working on a project that involves several pictures/movies etc. You have problems with telling which is which by simply reading their filenames.
  72.  
  73. Solution
  74. Create index files for your graphics and make sure they have previews. Now you can see which file is which. When you found the file you wanted you can simply drag and drop it on the program in Finder which you will use to edit the file with.
  75.  
  76. Situation
  77. You have CD-rom discs with graphics which you want to sort in a way that suits you. This is normally a problem because the CD is a read-only media.
  78.  
  79. Solution
  80. Create index files for the graphics from your CD:s and make sure they have previews. Now you can sort the graphics by draging and dropping items from one index file to several others. Press and hold the command-key during the drag to move the item to the destination index. Since the index files is stored on your harddisk you also have much faster access to the contents of your CD.s than you would if you where working in the Finder.
  81.  
  82.  
  83. Usage
  84. How you use QPict depends on how you work. If you mainly use graphics from CD-rom discs in your work you begin with creating index files for the contents of your CD:s. Once this is done you just have to open the index files when you need to find a picture/graphic etc. You don't have to have the CD mounted until you need access to the actual file. It's very easy to use QPict since it behaves like the Finder. You drag and drop between index documents and the Finder, double click on a picture to view it etc.
  85.  
  86. Textures
  87. You can change the texture used in both the index window and the background when displaying a picture. 
  88.  
  89. <To change texture in index window>
  90.  
  91. Select preferences from the File menu
  92. Check the "Use desk accessory pattern".
  93. Quit QPict.
  94. Open "Desktop Patterns" from the Control Panel Folder.
  95. Find the pattern you want to use.
  96. Hold down the option key while klicking on the "Set Desktop Pattern" button.
  97. Start QPict.
  98.  
  99. <To change texture in display window>
  100.  
  101. Select preferences from the File menu
  102. Check the "Use desktop pattern".
  103. Quit QPict.
  104. QPict now uses the same pattern as the one shown in the Finder.
  105.  
  106. Shortcuts
  107. <Index window>
  108. Select Shortcuts from the Window menu to display shortcuts available.
  109.  
  110. Other shortcuts:
  111.  
  112. Delete selected file       Command-backspace
  113.  
  114. <Display window>
  115. Select preferences from the File menu. Letters in light blue are shortcuts for the display window.
  116.  
  117. Other shortcuts:
  118.  
  119. View Next Picture          Right arrow
  120. View Previous Picture         Left arrow
  121. Return to Browser                Escape key or Mouse Button
  122. Delete Picture                      BackSpace
  123.  
  124. Preferences
  125.  
  126. <Display window>
  127. In this group you can select some aesthetical parameters that affect how the picture will be presented in view mode.
  128.  
  129. • Show draft picture
  130. If this checkbox i selected a draft version of the picture will be displayed during picture processing.
  131.  
  132. • Use custom palette
  133. If this checkbox i selected and your machine is running in 256 colours or less QPict will attempt to load a colour palette from the picture file. This greatly enhances the display quality because JPEG compressed pictures contains 16 millions of colours and if you are carefully about which 256 of these 16 millions of colours you choose you will optimize display quality. This option does not do anything if you are running in thousands or millions of colours. QPict currently does not support creation of colour palettes but future versions will. One program that supports creation of colour palettes is GIFConverter by Kevin A. Mitchell.
  134.  
  135. • Use custom crop
  136. If a crop resource is available in the picture file the picture is trimmed against it before is is shown.
  137.  
  138. • Scale to fit screen
  139. If this checkbox i selected pictures larger than the screen will be scaled down to fit. This greatly slows down the speed of display.
  140.  
  141. • Dither Picture
  142. If this checkbox i selected and your machine is running in 256 colours or less QPict will dither the picture.  This greatly enhances the display quality.
  143.  
  144. • Show file name
  145. If this checkbox i selected the name of the picture displayed will be shown in the bottom left corner of the picture.
  146.  
  147. • Show frame
  148. If this checkbox i selected a border will be drawn around the picture.
  149.  
  150. • Fade between items
  151. If this checkbox i selected QPict fades to black before next item is shown.
  152.  
  153. • Backgound pattern
  154. If this checkbox i selected background pattern is shown behind the picture.
  155.  
  156. <Index window>
  157. -- To be continued... 
  158.  
  159. Apple menu
  160.  
  161. < About QPict >
  162. Displays a nice about box with information about the program.  My e-mail adress is found here to and it's possible to copy it to the clipboard.
  163.  
  164. < Register... >
  165. Once you have sent in the registration fee you will receive a registration number that you use in the dialog you see when you select this menu command.
  166.  
  167. File menu
  168. This is a normal file menu. Note that this menu only handles index documents, not graphic files. Graphic files are opened by either dropping them (or the enclosed folder/disk) on QPict icon in the Finder or by dragging them into an open index document.
  169.  
  170. < New >
  171. Creates a new empty index document.
  172.  
  173. < Open >
  174. Open a index document from disk.
  175.  
  176. < Close >
  177. Closes the frontmost index document. Asks the user to save changes if the document is midified.
  178.  
  179. < Save, Save As... >
  180. Saves the frontmost document.
  181.  
  182. < Revert >
  183. Reverts to the last saved version of the index document.
  184.  
  185. < Reveal Original >
  186. Shows the file location of selected items in the index.
  187.  
  188. < Get Item Info >
  189. Opens a info window for selected items. This window contains info about the picture file and you can change the name of the item in the index. Comments can also be added here. The comments are currently only saved in the item file, not in the index. Because of this it's not possible to add comments for files that are located on write protected media such as CD-ROM. This will likely change in future versions of QPict.
  190.  
  191. < Preferences >
  192. Displays the preferences dialog. Many aspects of QPict can be customized here.
  193.  
  194. < Page Setup..., Print..., Print One >
  195. Prints the frontmost index document.
  196.  
  197. < Quit >
  198. Terminates the program.
  199.  
  200. Edit menu
  201. These menu commands works on selected items in the frontmost index document except "Create Previews".
  202.  
  203. < Undo >
  204. Not implemented in current version.
  205.  
  206. < Cut, Copy, Paste >
  207. Not implemented in current version.
  208.  
  209. < Clear >
  210. Removes the selected items from the index. Doesn't remove the actual files from the disk. Shortcut for this command is backspace.
  211.  
  212. < Select All >
  213. Selects all items in the frontmost index.
  214.  
  215. < Create Previews... >
  216. Creates preview pictures for files in the index. If no files are selected QPict creates previews for all files that don't already have one. If items are selected previews are created for those if they don't already have previews. If the option key is down QPict works as above but replaces already existing previews with new ones.
  217.  
  218. View menu
  219.  
  220. < Half Size, Normal Size, Double Size >
  221. Size of item in the index.
  222.  
  223. < by Name, by Size, by Type, by Date >
  224. Sort the items in the index.
  225.  
  226. < Show Kind >
  227. Displays the file kind in the upper left corner of every item in the index.
  228.  
  229. Scripts menu
  230.  
  231. < Slide Show >
  232. If no items are selected a slideshow is started with all the items in the index. Only files that are directly supported by QPict are shown (eg. PICT, JPEG and startup screen and GIF etc.).
  233.  
  234. < "Scripts" >
  235. Scripts or aliases to scripts that are located in the Scripts folder in the QPict directory is shown here. The selected script is applied to selected items in the index. Not implemented in current version.
  236.  
  237. Windows menu
  238.  
  239. < Shortcuts >
  240. Shows a list of key and mouse commands in QPict. Look through this list, it will make your life a lot easier. QPict was desgined to be a simple to use as possible with an uncluttered interface. Therefore many commands are not visible to the user directly.
  241.  
  242. < Stack >
  243. Stacks all open document windows in nice piles.
  244.  
  245. < "Document list" >
  246. All open documents are listed here for convinient access. The first documents have key commands 1 thru 9.
  247.  
  248.  
  249. Important info about memory management
  250. Because of the large memory usage of QPict and the quite limited memory management in the current Mac OS there are some things to be aware of when dealing with QPict. Current memory management in QPict is far from perfect but it will improve in future versions. When a application is started the Mac OS allocates a memory area for its use called application heap. The size of that area is user selectable in the info window for the application in the Finder. Normally all memory usage is within that area. The problem is that the size of the memory area is fixed once the program is started so the user must make sure that it is large enough for the document he/she wants to work with. When working with QPict you migt normally only use 3-4 MB but sometimes a whopping 10-12MB. In that case you would have to allocate 12MB for QPict all the time just in case you would open that large index files, that's not good. Instead QPict gives the user an option to use memory from the system instead for many memory requirements. That means that you can have 1.5-2.5MB allocated for QPict and still be able to open large index files. Another advantage with this is that memory allocation is much faster when using system memory on some machines. Using system memory is the default setting and the recommended one for most cases.
  251.  
  252.  
  253. Known conflicts
  254. • Resolution change doesn't work if Radius Dynamic Desktop is installed. Use either or.
  255.  
  256.  
  257. Known problems
  258. •    Scrambles order of items when dragging several items within the index. Use sort by to clean up
  259. •    Slow memory allocation on some machines. If it's slow, select "Use temp memory" in preferences
  260. •    Memory problem in 8 bit video (uses more memory in 8 bit than in 16/24 bit!). 
  261. • Finder sometimes reports error -1708 when dragging a file from QPict to Finder. This is a bug in the current System software.  This is still not fixed in System Update 2.0.
  262.  
  263. Limitations
  264. • Doesn't hide Control Strip on PowerMac unless QuickTime 2.1 is installed.
  265. • Supports a maximum of 600 items in one index document. Normally this is not a problem since you shouldn't work with  larger index files anyway.
  266.  
  267. Future attractions
  268. The following is just ideas of what could be incorporated in future versions of QPict. If you have any suggestions please let me know!. I would also like to know which features you think are important.
  269. •    Support for Copy/Paste/Undo
  270. •    Support for QuickTime movies (display and create previews)
  271. •    Constrained window resizing
  272. •    Watch Folder - QPict updates index when folder contents changes
  273. •    Help window
  274. •    Fully configurable filetype/applications list
  275. •    Double sized preview creation
  276. •    Custom icons creation
  277. •    Workaround Finder bug (Error -1708)
  278. •    Index update when original file has changed
  279. •    Online help
  280. •    Picture and index comments (searchable?).
  281.  
  282. Credits
  283. Malte Lewan for beta testing. <http://www.df.lth.se/~cml/>
  284. Johan Borg for beta testing.
  285. Bo Lindbergh for his DragLib.
  286. Glunet Communications AB for providing me free internet access.    <http://www.glunet.se>
  287. Greg Landweber for helping me out with a DragManager problem. <http://glandweb.student.harvard.edu/>
  288. Registered users of QPict for their comments and for supporting shareware.